home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 018 / pcfplus1.arc / READ.ME < prev   
Encoding:
Text File  |  1987-03-01  |  17.4 KB  |  408 lines
  1.  
  2.        +------------------------------------------------------+
  3.        |  Welcome to "User Supported Software" (Shareware).   |
  4.        |  This remarkable revolution in software distribution |
  5.        |  was  co-pioneered in 1982 by Jim Button and  Andrew |
  6.        |  Fluegelman.  It  has  become a  major  force in the |
  7.        |  software industry, helping to drive software prices |
  8.        |  down and eliminate copy protection schemes.         |
  9.        +------------------------------------------------------+
  10.  
  11.  
  12.               HERE'S HOW USER SUPPORTED SOFTWARE WORKS:
  13.  
  14. You are encouraged to copy the PC-File+ diskettes and share them freely with
  15. others.  You have the luxury of trying out the complete programs, at your
  16. own pace and in the comfort of your own home or workplace.  This is not a
  17. crippled or "demo" copy, but the complete working version of the program.
  18.  
  19. If, after trying out the programs, you decide to continue to use them, you
  20. are trusted to purchase PC-File+ from the program's author, or from an
  21. authorized dealer.
  22.  
  23.  
  24. Why pay at all?
  25. --------------------------------------------------------------
  26.    *  You receive a CURRENT copy of the program with a printed
  27.       manual
  28.    *  One year of technical support - by phone or written
  29.    *  Notification of updates (and fixes, if required)
  30.    *  Inexpensive upgrade offers
  31.    *  Notification of new products
  32.    *  Your input and ideas help shape future products
  33.    *  Periodic offers and "deals" (for our customers only)
  34.    *  Access to the on-line ButtonWare Bulletin Board, which
  35.       means:
  36.         - Information and announcements (on line)
  37.         - Communication with other ButtonWare users
  38.         - More technical support, and helpful tips/pointers
  39.    *  A sense of pride and ownership, in having honestly
  40.       participated in the User Supported software revolution
  41.    *  You help to keep software prices down, by supporting a
  42.       distribution method which doesn't rely on expensive
  43.       advertising campaigns.
  44.  
  45.  
  46. So please, dive in and enjoy the fun of legally sharing good software with
  47. your friends and associates.  But also be aware of the following
  48. restrictions, designed to protect the community of User Supported software
  49. users and authors, and to prevent greedy people from taking unfair advantage
  50. of the trust, hard work, and good will of User Supported software authors:
  51.  
  52. 1. No price or consideration may be charged. However, a distribution cost may
  53.    be charged for the cost of the diskettes, shipping, and handling, so long
  54.    as it's not more than $10 total.
  55.  
  56. 2. The files and programs on the disks may not be modified, deleted, nor
  57.    added to.
  58.  
  59. 3. The programs cannot be sold as part of some other more inclusive package.
  60.  
  61. 4. The programs cannot be "rented" or "leased" to others.
  62.  
  63. 5. The printed manuals cannot be copied or reproduced in any way.
  64.  
  65. 6. In the case of distribution via computerized "bulletin boards" or through
  66.    any other telecommunications link the following must be done:
  67.     *  X-Modem or some other error checking protocol must be used
  68.     *  All ButtonWare programs (and documentation files) must be
  69.        transferred in library format. That means the files have
  70.        all been combined into one file. You can get assistance with
  71.        this procedure from the Technical Support Department at
  72.        ButtonWare.
  73.  
  74. 7. If you're copying the disks for distribution to students in a classroom,
  75.    you must provide them with the following written notice:
  76.  
  77.       +-----------------------------------------------------+
  78.       | These diskettes are distributed to you through the  |
  79.       | courtesy of your school and instructor, and         |
  80.       | Jim Button.  No royalty or registration fee has     |
  81.       | been paid for the programs, which are for your use  |
  82.       | and evaluation as a student.                        |
  83.       |                                                     |
  84.       | If you wish to receive technical support from       |
  85.       | ButtonWare, as well as announcements of updates and |
  86.       | improvements to the programs, you must first become |
  87.       | a "registered user."  You do that by purchasing     |
  88.       | each program you plan to use - from an authorized   |
  89.       | dealer or directly from ButtonWare:                 |
  90.       |                                                     |
  91.       |                    Jim Button                       |
  92.       |                  P.O.  Box 5786                     |
  93.       |                Bellevue, WA 98006                   |
  94.       |                                                     |
  95.       | You may also purchase by calling our toll-free      |
  96.       | order line, 1-800-JBUTTON.                          |
  97.       +-----------------------------------------------------+
  98.  
  99.  
  100.                 +-----------------------+
  101.                 | NOTES AND             |
  102.                 | UNDOCUMENTED FEATURES |
  103.                 +-----------------------+
  104.  
  105. The following notes pertain to this version of PC-File+, but were too
  106. late to make it into the manual.
  107.  
  108. ---------------------------------------------------------------------------
  109. Please make certain that the CONFIG.SYS file on your bootup disk contains
  110. this statement:   FILES=20
  111. The number may be 20 or larger. This is covered on page 20 in the manual.
  112. ---------------------------------------------------------------------------
  113. You have a choice of a third color on your screens.  The third color will
  114. be used for additional highlighting.  This helps to make the data stand out
  115. separately from the field names on the screen, easing eye strain and
  116. operator fatigue.  You can set the third color by using the Setup option
  117. from the Utilities command on the master menu screen.  Power users can also
  118. modify the profile files directly, adding the /FG2,n command (see the
  119. "Quick Reference Card")
  120. ---------------------------------------------------------------------------
  121. There is a sample database included on your supplemental programs diskette.
  122. It's called "PEOPLE".  You can use it to keep track of friends,
  123. acquaintances, customers, business contacts, etc.  It also contains
  124. pre-defined smart keys to print mailing labels, phone directories,
  125. envelopes, rolodex cards, etc.  PC-File+ with the PEOPLE database is far
  126. superior to most of the "mailing-list manager" programs on the market.
  127. ---------------------------------------------------------------------------
  128. You can turn TEACH mode on or off from anywhere in the program (not just
  129. from the Master Menu screen as stated in the manual.)  To turn TEACH mode
  130. on or off at any time, press (Alt)T.
  131. ---------------------------------------------------------------------------
  132. "Drop to DOS", (Alt)D, does not work with DOS versions 2.10 or earlier, nor
  133. with Zenith MSDOS 2.11 and Compaq MSDOS 2.12.  This appears to be caused by
  134. a bug in some of the earlier versions of DOS.  We have not had any problems
  135. with later versions of DOS.
  136. ---------------------------------------------------------------------------
  137. There are some other text files on your supplemental program disk
  138. worth taking a look at:
  139.     CHANGES  - detailed account of differences between PC-File+ and
  140.                the previous version of PC-File III or PC-File/R
  141.     PRODUCTS - Short review of ButtonWare products, and an order form
  142.     RESPONSE - A user feedback survey. We really like to receive these
  143.                from you.
  144. ---------------------------------------------------------------------------
  145. In spite of indications in the manual to the contrary, PC-File+
  146. only runs in the FOREGROUND under TopView and Microsoft Windows.
  147. ---------------------------------------------------------------------------
  148. A new feature was added to the cloning routine.  When asked to enter the
  149. name of the field which contains the data, you can enter a number sign, # .
  150. The # sign will cause PC-File+ to use the current relative record number
  151. for the field.
  152.  
  153.  
  154.  
  155. ---------------------------------------------------------------------------
  156. CORRECTIONS TO THE USER'S GUIDE
  157.  
  158. Page 17, item 4  should read:
  159.         4. Format the diskette in the  B  drive.  This is done
  160.            by typing:
  161.                        FORMAT  B:
  162.  
  163. Page 46, largest paragraph, please note carefully:
  164.         The character to place at the end of field names for numeric
  165.         fields is the "#" (pound) sign, not the asterisk. This is
  166.         correctly stated in the manual, but it's easy to get confused
  167.         because of the similar appearance of the two characters.
  168.  
  169. Page 82 fails to mention that there are two types of print edit masks
  170.         that can be used to create a floating "check protection" type
  171.         of output. Here are two examples:
  172.         [AMOUNT]:$$$,$$#.##:
  173.             creates a floating dollar sign, example    $12.34
  174.         [AMOUNT]:***,**#.##:
  175.             creates "asterisk filled" output, like  ****12.34
  176.  
  177. Page 94, example given at bottom of page should be:
  178.         EXAMPLE:  .<(AGE*364.25):zz,zz#.##:>
  179.  
  180. Page 95, example given at top of page should be:
  181.         EXAMPLE:  .<(@PARTNO,PARTSDB,PART,DESC):@@@@@:>
  182.  
  183. Page 173, next to last line, should start out:
  184.         The combination  "0,' ',0"  will cause PC-File+ to
  185.  
  186.  
  187.  
  188.          +---------------------------------+
  189.          |  PC-FILE+ QUICK REFERENCE CARD  |
  190.          +---------------------------------+
  191.  
  192.  
  193. SPECIAL KEYS WHEN TYPING
  194.  
  195. KEY                    FUNCTION
  196. -------      ----------------------------------------------
  197. (Alt)D       drop to DOS
  198. (Alt)H       HELP
  199. (Alt)T       TEACH mode (on/off)
  200. (Alt)Y       Smart Key Memorize (on/off)
  201. (Ctrl)A      accept data (same as (F10))
  202. (Ctrl)B      blank right, to end of field
  203. (Ctrl)D      duplicate all of previous record
  204. (Ctrl)F      duplicate Field from previous record
  205. (Ctrl)L      print a Label (Snapshot)
  206. (Ctrl)R      read into memory
  207. (Ctrl)W      write from memory
  208. (Del)        delete the character at the cursor
  209. down arrow   move cursor to following field or line
  210. (End)        cursor right, past last significant character
  211. (Enter)      move cursor to next field
  212. (Esc)        cancel this operation
  213. (F10)        accept data
  214. (Home)       cursor left, to start of field
  215. (Ins)        Insert mode (on/off)
  216. left arrow   move cursor left 1 position
  217. (PgDn)       cursor to last input field on screen, or
  218.                page down (in browse mode)
  219. (PgUp)       cursor to first input field on screen, or
  220.                page up (in browse mode)
  221. right arrow  move cursor right 1 position
  222. tab          move cursor to next field, or
  223.                move browse window one field to the right
  224. tab left     move cursor to prior field, or
  225.                move browse window one field to the left
  226. tilde (~)    the "flip data" character
  227. up arrow     move cursor to preceding field or line
  228.  
  229.  
  230. DEFINING THE DATA BASE
  231.     Special Characters
  232.        #     At the end of the field name creates a numeric
  233.              field.  Example: QTY#
  234.     Edit mask examples:
  235.        :azAZ:     allows only alphabetic characters
  236.        :AAaaEEeeIIiiOOooUUuu: allows only vowels
  237.        :09//--  : good for date fields
  238.     Automatic Fields (In edit mask area)
  239.        :DATE*:      mm-dd-yy         :TIME*:    hh:mm
  240.        :MM/DD/YY*:  mm/dd/yy         :UNIQUE*:  unique no.
  241.        :DD/MM/YY*:  dd/mm/yy         :DUPE*:    auto dupe
  242.        :YYMMDD*:    yymmdd
  243.        :MO*:        mm
  244.        :DY*:        dd
  245.        :YR*:        yy
  246.     Automatic field can also have an input edit mask:
  247.        :DATE*09//:
  248.     Automatic field only when adding records:
  249.        :DATE*A:
  250.     Automatic field only when modifying:
  251.        :DATE*M:
  252.     Automatic Constant
  253.        "New York City"
  254.        "Des Moines"*A         (only when adding records)
  255.        "Milton Freewater"*M   (only when modifying)
  256.     Calculated fields example:
  257.        ((cost + adjustments) / 100).2
  258.     Relational lookup example:
  259.        (@empno,empmast,empno,salary)
  260.  
  261.  
  262. FIND: TYPES OF SEARCHES (SEARCH "SIMPLE")
  263.     xxx         generic (exact, first part)
  264.     ~xxx        scan across
  265.     ?xxx        soundex (sounds like)
  266.     ___x        wildcard
  267.  
  268.  
  269. WHEN CALCULATIONS ARE ASKED FOR:
  270.     example arithmetic calculation:
  271.             ((cost + adjust) / 100)
  272.     example comparison calculation:
  273.             ((age >= 21 & age < 40) & sex = "F")
  274.     arithmetic operators:
  275.         +   addition
  276.         -   subtraction or negation
  277.         *   multiplication
  278.         /   division
  279.         %   modulo (remainder)
  280.         ^   exponentiation
  281.     logical operators:
  282.         &   and
  283.         |   or
  284.     comparison operators:
  285.         =   equal
  286.         !=  not equal
  287.         >   greater than
  288.         >=  greater than or equal
  289.         <   less than
  290.         <=  less than or equal
  291.  
  292.  
  293. COMMANDS WITHIN SMART KEY DATA
  294.     [2]    simulate "blank to right" key
  295.     [4]    simulate "dupe record" key
  296.     [6]    simulate "dupe field" key
  297.     [9]    simulate tab-rt key
  298.     [12]   simulate "Snapshot Label" key
  299.     [13]   simulate (Enter) key
  300.     [18]   simulate "read into memory" key
  301.     [23]   simulate "write from memory" key
  302.     [271]  simulate tab-left key
  303.     [324]  simulate (F10) key
  304.     [328]  simulate cursor up key
  305.     [335]  simulate End key
  306.     [336]  simulate cursor down key
  307.     [338]  simulate Ins key
  308.     [339]  simulate Del key
  309.     ^n     imbed SMART KEY #n
  310.     ^K     get keyboard input
  311.  
  312.  
  313. REPORT COMMAND LANGUAGE
  314.  The sections of the report
  315.   :COVER       prints once at beginning of report
  316.   :HEADING       "    at top of each page
  317.   :DETAIL        "    once for each record printed
  318.   :SUBTOTAL      "    at each subtotal break
  319.   :FOOTING       "    at bottom of each page
  320.   :TOTAL         "    at end of the report
  321.  Commands in print control file (1 command per line):
  322.   [xxx]               field xxx data prints here
  323.   [COUNT*]            print count of records printed so far
  324.   [DATE*]             today's date prints here
  325.   [KEYIN*prompt]      ask operator input, print here
  326.   [PAGE*]             print page number here
  327.   [RECORD*]           print record no. of the current record
  328.   [RECORDS*]          print no. of rcds in database
  329.   [SELECT*]           print the selection criteria
  330.   [SORT*]             print the primary sort field name
  331.   [SUBCOUNT*]         print count of rcds in subtotal group
  332.   [SUBFLD*]           print field name of subtotal break fld
  333.   [SUBID*]            print data from subtotal break field
  334.   [TIME*]             the current time prints here
  335.   A nn,nnn,nn         print ASCII printer control codes here
  336.   <xxx>               field xxx data (excess spaces removed)
  337.   "xxx"               a constant
  338.   =nn                 tab to column nn
  339.   /n                  insert n newlines
  340.   .FF                 form feed to new page
  341.   .CP nn              conditional skip to new page
  342.   (a+b):z,zz#.##:     a calculated answer
  343.   (#):zz,zz#:         relative record number
  344.   (@K1,DB,k2,x2):@@@: relational lookup
  345.  
  346. MAIL-MERGE COMMANDS  (IMBED IN LETTER)
  347.  .<fieldname>            insert data, blanks stripped
  348.  .[fieldname]            insert data, no blanks removed
  349.  .<KEYIN*prompt>         insert data from keyboard
  350.  .<DATE*>                insert today's date
  351.  .GROUP                  start a group (no blank lines)
  352.  .EGROUP                 end a group
  353.  .EGROUP R               end a group, replace blank lines
  354.  .FORMFEED               skip to new page on printer
  355.  .FF                     skip to new page on printer
  356.  .CP nn                  conditional skip to new page
  357.  .<(a+b):z,zz#.##:>      a calculated answer
  358.  .<(@K1,DB2,k2,x2):@@@:> a relational lookup answer
  359.  
  360.  
  361. SORT ALTERNATIVES (SORT FIELD #1)
  362.     fieldname       sort on entire field
  363.     fieldname,1,2   data starts in byte=1, length=2
  364.     fieldname,R     Roman Numeral sort
  365.     fieldname,S     Soundex sort
  366.     RANDOM*         random sequence
  367.  
  368.  
  369. COMMANDS IN PROFILE FILES
  370.  /AUTOSKIP       automatic skip to next field when full
  371.  /BG,n           set background screen color 0-7 (note 1)
  372.  /CASEFIND       searches will be case sensitive
  373.  /CASESORT       sorts will be case sensitive
  374.  /CONDENSED,n,n  ASCII values to cause condensed print
  375.  /DRIVE,x        default disk for data
  376.  /FG,n           set foreground screen color 0-15 (note 1)
  377.  /FG2,n          set alternate foreground color for field names
  378.  /FILE,xxx       default database name
  379.  /KEYIN,xxx      keystrokes to run at startup
  380.  /LBL,xxx        gives Snapshot Label format (note 2)
  381.  /MODPW,xxx      password allowing changes in data
  382.  /NORMAL,n,n     ASCII values to cause normal print size
  383.  /PAGELEN,n      size of page (no. of print lines)
  384.  /PATH,xxx       default subdirectory for data
  385.  /PRPORT,LPTx:   printer output port
  386.  /SORTPW,xxx     password allows sorts on database
  387.  /SYSPW,xxx      password allows system operations
  388.  /USEPW,xxx      password allows use of the database
  389.  /XXXPW,xxx      password allows override of all passwords
  390.  
  391. Note 1.
  392.  Screen colors: bg 0-7, fg 0-15
  393.      0 black   4 red        8 gray        12 lt. red
  394.      1 blue    5 magenta    9 lt. blue    13 lt. magenta
  395.      2 green   6 brown     10 lt. green   14 yellow
  396.      3 cyan    7 white     11 lt. cyan    15 bright white
  397.  
  398. Note 2.
  399.     Snapshot Feature specification:
  400.     dev,t,f,f,f,f......
  401.         dev = LPT1:, LPT2:, MYFILE, etc.
  402.         t   = no. chars to tab in at left margin
  403.         f   = field number, or command
  404.               0   = new line
  405.              -n   = insert n spaces
  406.              'xx' = insert xx (a constant)
  407.  
  408.